home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / earcd / comm / misc / makezcma.lha / MakeZCMail.dok < prev    next >
Text File  |  1997-02-06  |  13KB  |  384 lines
  1.  
  2. ==============================================================================
  3. Programm: MakeZCMail
  4. Version : V1.7
  5. Datum   : 06.02.97
  6. Funktion: Erstellt aus Ascii-Files oder Binär-Files 100% ZConnect-konforme
  7.           Puffer zum Posten an EMail Adressen oder Bretter
  8. ==============================================================================
  9.  
  10.  
  11. Aufruf
  12. ======
  13.  
  14. Hard-Disk:Progger/sc/eigene/MakeZCMail> MakeZCMail ?
  15. ABS=ABSENDER/A,EMP=EMPFAENGER/A,DO=DOMAIN/A,PU=PUFFER/A,QU=QUELLDATEI/A,
  16. BET=BETREFF/K,RN=REALNAME/K,ZU=ZUSAMMENFASSUNG/K,DI=DISKUIN/K,
  17. AA=ANTWORTAN/K,O=ORG/K,TEL=TELEFON/K,PO=POST/K,BIN=BINAER/S,EB=EMPFANGSB/S,
  18. PR=PRIO/N,P=POINT/S,KOM=KOMMENTAR/K,NR=NOROT/S:  ?
  19.  
  20.  Usage: MakeZCMail
  21.  
  22.  ABS = ABSENDER   = <Absender>      | EMP = EMPFAENGER      = <Empfaenger>
  23.   DO = DOMAIN     = <Domain>        |  PU = PUFFER          = <Puffername>
  24.   QU = QUELLDATEI = <Quelldatei>    | BET = BETREFF         = <Betreff>
  25.   RN = REALNAME   = <Realname>      |  ZU = ZUSAMMENFASSUNG = <Zusammenfassung>
  26.   DI = DISKUIN    = <Diskussion-In> |  AA = ANTWORTAN       = <Antwort-An>
  27.    O = ORG        = <Organisation>  | TEL = TELEFON         = <Telefonnr>
  28.   PO = POST       = <Postanschrift> | BIN = BINAER          = <Binaer>
  29.   EB = EMPFANGSB  = <Empfangsbest.> |  PR = PRIO            = <Prioritaet>
  30.    P = POINT      = <Point>         | KOM = KOMMENTAR       = <Kommentar>
  31.   NR = NOROT      = <Leerer ROT:>
  32.  
  33.          Absender = Absender der Mail, z.B. SYSOP
  34.        Empfaenger = Empfaenger der Mail, z.B. /!RECENT
  35.            Domain = Boxname UND Domain der Mailbox, z.B. dame.de
  36.            Puffer = Names des Puffer, also der Zieldatei
  37.        Quelldatei = Name des File das umgewandelt werden soll
  38.           Betreff = Betreff der Mail
  39.          Realname = Der Realname des Absenders
  40.   Zusammenfassung = Kurzkommentar der Nachricht
  41.           DiskuIn = Diskussion-In setzen
  42.          AnwortAn = Antwort-An setzen
  43.               Org = Organisation z.B. CoSysop der Notre Dame
  44.           Telefon = Telefonnummer(n)
  45.              Post = Postanschrift
  46.         Kommentar = File, das als Kommentar benutzt werden soll
  47.               Bin = Angeben, wenn Mail eine Binaernachricht ist
  48.                Eb = Angeben, wenn Empfangsbestaetigung erwuenscht
  49.              Prio = Prioritaet. Erlaubt sind 10 (Direkt) oder 20 (Eil)
  50.             Point = Wenn MID mit dem Absender geschrieben werden soll
  51.             NoRot = Bewirkt, dass ein leerer ROT: geschrieben wird
  52.  
  53. :
  54.  
  55. ------------------------------------------------------------------------------
  56.  
  57. ABSENDER: (Pflicht)
  58.  
  59.      Hier wird der Absender eingegeben (NUR der Username!!!!!!).
  60.      Beispiel: "system"
  61.  
  62.  
  63. EMPFÄNGER: (Pflicht)
  64.  
  65.      Der Empfänger der Nachricht. Es kann sich um eine Brettnachricht
  66.      oder eine Mail an einen anderen Teilnehmer handeln.
  67.  
  68.      Beispiel: "tms@dame.de" oder "/de/test"
  69.  
  70.  
  71. DOMAIN: (Pflicht)
  72.  
  73.      Die Domain und der Systemname des postenden Systems.  Ist wichtig für
  74.      den Routestring und der Erstellung der MessageID !
  75.  
  76.      Beispiel: "netzname.do.main"
  77.  
  78.  
  79. PUFFER: (Pflicht)
  80.  
  81.      Name des Puffer, also der Zieldatei, die der ZConnect-Puffer sein soll.
  82.      Hierbei ist zu beachten, das MakeZCMail als Filekommentar gleichzeitig
  83.      den eingegebenen String von "ABSENDER" einfügt. Prometheus-Systeme profi-
  84.      tieren sehr davon, da der Sorter automatisch weiß, von wem der Puffer
  85.      angeblich stammt.
  86.  
  87.      Beispiel: "PROMETHEUS:Netz/Sortin/MakeZCMail-puffer.prv"
  88.  
  89.  
  90. QUELLDATEI: (Pflicht)
  91.  
  92.      Das File, das verschickt werden soll. Es kann sich dabei um eine
  93.      Textnachricht oder um ein Binaerfile handeln. Bei Textnachrichten
  94.      ist die Terminierung der Zeilen egal (LF oder CR/LF), da MakeZCMail die
  95.      Zeilen automatisch konvertiert.
  96.  
  97.      Beispiel: "Werbung:Mailboxwerbung"
  98.  
  99.  
  100. BETREFF: (Optional)
  101.  
  102.      Der Betreff der Nachricht :)
  103.      Wird kein Betreff angeben, so wird der Name der Quelldatei als Betreff
  104.      genommen.
  105.  
  106.      Es ist dringend zu beachten, dass hier "BETREFF" angeben werden muss,
  107.      da dieses Keyword optional ist.
  108.  
  109.      Beispiel: BETREFF="Testnachricht mit MakeZCMail"
  110.  
  111.  
  112. DISKUIN: (Optional)
  113.  
  114.      Wird dies angeben, so wird Diskussion-In: gesetzt.
  115.  
  116.      Es ist dringend zu beachten, dass hier "DISKUIN" angeben werden muss,
  117.      da dieses Keyword optional ist.
  118.  
  119.      Beispiel: DISKUIN="/Z-Netz/Rechner/Amiga/Allgemein"
  120.  
  121.  
  122. ANTWORTAN: (Optional)
  123.  
  124.      Wird dies angeben, so wird Antwort-An: gesetzt.
  125.  
  126.      Es ist dringend zu beachten, dass hier "ANTWORTAN" angeben werden muss,
  127.      da dieses Keyword optional ist.
  128.  
  129.      Beispiel: ANTWORTAN="TMS@dame.de"
  130.  
  131.  
  132. ZUSAMMENFASSUNG: (Optional)
  133.  
  134.      Wird dies angeben, so wird dies als Zusammenfassung geschrieben.
  135.  
  136.      Es ist dringend zu beachten, dass hier "ZUSAMMENFASSUNG" angeben
  137.      werden muss, da dieses Keyword optional ist.
  138.  
  139.      Beispiel: ZUSAMMENFASSUNG="Dies ist die Zusammenfassung der Mail"
  140.  
  141.  
  142. KOMMENTAR: (Optional)
  143.  
  144.      Wird dies angeben, so wird das uebergebene FILE als Kommentar
  145.      geschrieben. Bitte beachten, dass hier nur ein FILE als
  146.      Parameter akzeptiert wird. Moechte man einen Text uebergeben, so
  147.      ist dafuer der Header ZUSAMMENFASSUNG vorgesehen.
  148.  
  149.      Weiterhin weise ich darauf hin, dass das FILE ein TEXTFILE, und
  150.      KEIN BINAERFILE sein MUSS!
  151.  
  152.      Es ist dringend zu beachten, dass hier "KOMMENTAR" angeben
  153.      werden muss, da dieses Keyword optional ist.
  154.  
  155.      Beispiel: KOMMENTAR="GATEWAY:Download/Cheater.readme"
  156.  
  157.  
  158. ORG: (Optional)
  159.  
  160.      Wird dies angeben, so wird dies als Organisation geschrieben.
  161.  
  162.      Es ist dringend zu beachten, dass hier "ORG" angeben werden muss,
  163.      da dieses Keyword optional ist.
  164.  
  165.      Beispiel: ORG="CoSysop der Notre Dame BBS Hamburg"
  166.  
  167.  
  168. TELEFON: (Optional)
  169.  
  170.      Wird dies angeben, so wird dies als Telefonnummer geschrieben.
  171.  
  172.      Es ist dringend zu beachten, dass hier "TELEFON" angeben werden muss,
  173.      da dieses Keyword optional ist.
  174.  
  175.      Beispiel: TELEFON="++49 [40] 648 932 87"
  176.  
  177.  
  178. POST: (Optional)
  179.  
  180.      Wird dies angeben, so wird dies als Postangschrift geschrieben.
  181.  
  182.      Es ist dringend zu beachten, dass hier "POST" angeben werden muss,
  183.      da dieses Keyword optional ist.
  184.  
  185.      Beispiel: POST="Anklamer Ring 58 ; 22147 Hamburg"
  186.  
  187.  
  188. REALNAME: (Optional)
  189.  
  190.      Wird dies angeben, so wird an den Absender der Realname angehaengt.
  191.  
  192.      Der Realname MUSS in () geschrieben werden!
  193.  
  194.      Der Realname sollte keine Umlaute "üöäÜÖÄß" beinhalten.
  195.  
  196.      Es ist dringend zu beachten, dass hier "REALNAME" angeben werden muss,
  197.      da dieses Keyword optional ist.
  198.  
  199.      Beispiel: REALNAME="(Mirko Thoele)"
  200.  
  201.  
  202. POINT: (Optional) (Switch)
  203.  
  204.         Wird dieser Switch uebergeben, so wird die MID: anders zusammengesetzt.
  205.       Sie wird in diesem Fall als "ursprung@absender.system.domain"
  206.       geschrieben. Wird dieser Switch NICHT angegeben, so setzt sich die
  207.       MID: aus "ursprung@system.domain" zusammen. Die Parameter die im
  208.       ersteren Falle genommen werden sind "xxx@absender.domain" und im
  209.       zweiten Falle "xxx@domain". Ich weise nochmal darauf hin, das die
  210.       Domain, die als Parameter uebergeben wird aus "netzname.do.main"
  211.       zusammengesetzt sein muss.
  212.  
  213.  
  214. BIN: (Optional) (Switch)
  215.  
  216.      Wird dieser Switch uebergeben, so wird eine Binaernachricht erzeugt.
  217.      In diesem Fall wird keine Lineendungskonvertierung ups :) vorgenommen
  218.      und ein zusaetzlicher Header FILE: erzeugt, der den Originalfilenamen
  219.      beschreibt (ohne Pfadangabe).
  220.  
  221.  
  222. EB: (Optional) (Switch)
  223.  
  224.      Wird dieser Switch uebergeben, so wird eine Empfangsbestaetigung
  225.      vom Empfaenger erbeten.
  226.  
  227.  
  228. NOROT: (Optional) (Switch)
  229.  
  230.      Wird dieser Switch uebergeben, so wird ein leerer ROT: Header
  231.      geschrieben.
  232.  
  233.  
  234. PRIO: (Optional) (Numerisch)
  235.  
  236.      Moeglich sind hier 10 oder 20.
  237.      Bei einer 10 wird die Mail als Direktmail, bei einer 20 als Eilmail
  238.      verschickt. Jeder andere Wert wird ignoriert.
  239.  
  240.      Es ist dringend zu beachten, dass hier "PRIO" angeben werden muss,
  241.      da dieses Keyword optional ist.
  242.  
  243.      Beispiel: PRIO=10
  244.  
  245.  
  246. Beispiele
  247. =========
  248.  
  249.   Verschicken eine Textnachricht an einen Netzteilnehmer
  250.   ------------------------------------------------------
  251.  
  252. MakeZCMail "Sysop" "tms@dame.de" "dame.de" "PROMETHEUS:netz/sortin/bla.prv"
  253.            "S:StartUp-Sequence"  BETREFF="TEST!"
  254.  
  255.  
  256.   Verschicken eine Textnachricht an ein Brett
  257.   -------------------------------------------
  258.  
  259. MakeZCMail "Sysop" "/de/test/" "dame.de" "PROMETHEUS:netz/sortin/bla.prv"
  260.            "S:StartUp-Sequence"  BETREFF="TEST!"
  261.  
  262.  
  263.   Verschicken eine Binaernachricht an einen User
  264.   ----------------------------------------------
  265.  
  266. MakeZCMail "Sysop" "tms@dame.de" "dame.de" "PROMETHEUS:netz/sortin/bla.prv"
  267.            "c:lha" BETREFF="Die 68000er Version!" BIN
  268.  
  269.  
  270.   Verschicken eine Binaernachricht an ein Brett
  271.   ---------------------------------------------
  272.  
  273. MakeZCMail "Sysop" "/de/test" "dame.de" "PROMETHEUS:netz/sortin/bla.prv"
  274.             "c:dir" BETREFF="Binary test" BIN
  275.  
  276.  
  277. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  278.  
  279. MakeZCMail ist (C) by Mirko Thöle  (TMS@DAME.DE)
  280.  
  281. MakeZCMail wurde entwickelt, weil das Programm "SMail V1.0" KEINEN Routestring
  282. erstellte, und auch immer falsche (futuristische) EDA: Angaben kreierte. Bei
  283. vielen Mailboxen und Pointprogramm-filtern wurde dieses Mail beanstandet.
  284.  
  285. Wer einen kleinen Obolus an mich entrichten moechte, weil dieses Tool ihm
  286. vielleicht Arbeit ersparen kann, der kann dies auf folgendes Konto machen:
  287.  
  288. Mirko Thoele
  289. Postgiro Hamburg
  290. BLZ: 200 100 20
  291. KTN: 641212 - 204
  292.  
  293. Ich sag dann schonmal von hier aus Danke. 8-)
  294.  
  295. Die Original "IDEE" und die Grundlage dieser Dok, liegen eindeutig bei
  296. SMail V1.0 (c) Kai Szymanski.
  297.  
  298. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  299.  
  300. Bekannte Bugs:
  301. --------------
  302.  
  303. Datumserstellung ist nicht 100% korrekt.  Ich bin mir im Moment nicht
  304. darueber im klaren, wie ich die Offsets fuer die Zeitzonen richtig
  305. berechnen kann/muss.
  306.  
  307. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  308.  
  309. Changes:
  310. --------
  311. 1.0 - 1.1 (21.10.96)
  312.  - ANTWORT-AN: hinzugefuegt.
  313.  - TELEFON: hinzugefuegt.
  314.  - ORG: hinzugefuegt.
  315.  - AllocVec durch AllocRemember ersetzt.
  316.  
  317. 1.1 - 1.2 (29.12.96)
  318.  - PRIO: hinzugefuegt.
  319.  - POST: hinzugefuegt.
  320.  
  321. 1.2 - 1.3 (04.01.97)
  322.  - KOM: hinzugefuegt.
  323.    ACHTUNG! Vorher wuerde bei der Parameteruebergabe von KOM="Kommentar"
  324.    statt des KOM: Headers der ZUSAMMENFASSUNG: Header geschrieben.
  325.    Dies war falsch! ZU=<Zusammenfassung> wird jetzt stattdessen benutzt!.
  326.  
  327.  - BOOL Point hinzugefuegt.
  328.    Wird dieser Switch mit angegeben, so wird die MID: als
  329.    ursprung@absender.system.domain geschrieben, und nicht wie vorher als
  330.    ursprung@system.domain.
  331.  
  332.  - Es existierte ein boeser Fehler in der Dokumentation!
  333.    DOMAIN=<Domain> besteht natuerlich nicht alleine aus der Domain, sonder
  334.    aus "netzname.do.main".
  335.  
  336.  - "Extended Help" erweitert. (Erreicht man durch "MakeZCMail ?", und
  337.                                nochmaliges eingaben von "?")
  338.  
  339.  - ACHTUNG: Wenn MakeZCMail in Scripten verwendet wird, bitte nochmal
  340.             ueberpruefen ob eure Aufrufe noch stimmen, da sich dort
  341.             etwas geaendert haben kann!!! (PU=PUFFER / P=POINT / PR=PRIO)
  342.  
  343.  - Bug gefunden (und behoben), der zum Speicherverlust fuehren konnte.
  344.  
  345. 1.3 - 1.4 (10.01.97)
  346.  - Bug behoben, der auftrat wenn der KOM Header nicht angegeben war.
  347.  
  348. 1.4 - 1.5 (01.02.97)
  349.  - Wird kein Realname angegeben, so wird nun nicht mehr ein zusaetzlicher
  350.    Leerschritt nach dem Usernamen geschrieben.
  351.  
  352.  - Statt FPrintf() beim Schreiben des Mailbodys wird nun FWrite() benutzt.
  353.    Dies haette ich von Anfang an tun sollen, aber ich rechnete einfach
  354.    nicht damit, dass jemand Mails schreibt, die 100KB und groesser sind.
  355.    Wie dem auch sei, FPrintf() kommt jedenfalls nicht mit Strings zurecht
  356.    die eine bestimmte Groesse ueberschreiten. Dies bewirkte bei grossen
  357.    Mails Fehler. (Anmerkung: Beim testen ist mir aufgefallen, dass das
  358.                              Einlesen der Mail ja Arschlangsam ist.
  359.                              Beizeiten wohl mal ueberarbeiten..)
  360.  
  361.  - BOOL NOROT hinzugefuegt.
  362.  
  363.  
  364. 1.5 - 1.6 (03.02.97)
  365.  - Bugfix: Beim schreiben der Kommentare konnte es noch zu Fehlern kommen, muesste nun 
  366.    gefixt sein. 
  367.  
  368.  - Debuginformationen im Source uebersehen %-(.
  369.    (Vielleicht sollte man sich mit dem testen doch mal ein wenig Zeit lassen)
  370.  
  371.  - Verschiedene Tests, die Routine zum einlesen zu verschnellern
  372.    (Blockweises einlesen / Konvertieren der Zeilen) schlugen fehl, Habe im
  373.    Moment keine Idee wie ich diese ziemlich langsame Routine verschnellern
  374.    kann.
  375.  
  376.  
  377. 1.6 - 1.7 (06.02.97)
  378.  - Einlesen und Konvertieren der Mails um ein vielfaches verschnellert.
  379.    Dies kommt vor allen Dingen bei grossen Mails zum tragen.
  380.    Der entscheidene Tip kam im diesem Falle von Siliconsurfer.  (Es geht
  381.    nunmal wirklich schneller, wenn man strcat() einen Pointer auf das Ende
  382.    des String uebergibt, und nicht auf den Anfang des Strings)
  383.  
  384.